home *** CD-ROM | disk | FTP | other *** search
/ Sprite 1984 - 1993 / Sprite 1984 - 1993.iso / man / cmds.fmt / whereis.man < prev    next >
Encoding:
Text File  |  1989-05-24  |  2.0 KB  |  67 lines
  1.  
  2.  
  3.  
  4. WHEREIS                   User Commands                   WHEREIS
  5.  
  6.  
  7.  
  8. NNAAMMEE
  9.      whereis - locate source, binary, and or manual for program
  10.  
  11. SSYYNNOOPPSSIISS
  12.      wwhheerreeiiss [ --ssbbmm ] [ --uu ] [ --SSBBMM dir ...  --ff ] name ...
  13.  
  14. DDEESSCCRRIIPPTTIIOONN
  15.      _W_h_e_r_e_i_s locates source/binary and manuals sections for
  16.      specified files.  The supplied names are first stripped of
  17.      leading pathname components and any (single) trailing exten-
  18.      sion of the form ``.ext'', e.g. ``.c''.  Prefixes of ``s.''
  19.      resulting from use of source code control are also dealt
  20.      with.  _W_h_e_r_e_i_s then attempts to locate the desired program
  21.      in a list of standard places.  If any of the --bb,, --ss or --mm
  22.      flags are given then _w_h_e_r_e_i_s searches only for binaries,
  23.      sources or manual sections respectively (or any two
  24.      thereof).  The --uu flag may be used to search for unusual
  25.      entries.  A file is said to be unusual if it does not have
  26.      one entry of each requested type.  Thus ``whereis -m -u *''
  27.      asks for those files in the current directory which have no
  28.      documentation.
  29.  
  30.      Finally, the --BB --MM and --SS flags may be used to change or
  31.      otherwise limit the places where _w_h_e_r_e_i_s searches.  The --ff
  32.      file flags is used to terminate the last such directory list
  33.      and signal the start of file names.
  34.  
  35. EEXXAAMMPPLLEE
  36.      The following finds all the files in /usr/bin which are not
  37.      documented in /usr/man/man1 with source in /usr/src/cmd:
  38.  
  39.           cd /usr/ucb
  40.           whereis -u -M /usr/man/man1 -S /usr/src/cmd -f *
  41.  
  42. FFIILLEESS
  43.      /usr/src/*
  44.      /usr/{doc,man}/*
  45.      /lib, /etc, /usr/{lib,bin,ucb,old,new,local}
  46.  
  47. BBUUGGSS
  48.      Since the program uses _c_h_d_i_r(2) to run faster, pathnames
  49.      given with the --MM --SS and --BB must be full; i.e. they must
  50.      begin with a ``/''.
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63. Sprite v1.0                May 7, 1986                          1
  64.  
  65.  
  66.  
  67.